Home
Installing
An HCL Launch installation consists of the HCL Launch server, a database, and at least one agent.
Installing the server
The server provides services such as the user interface used to configure application deployments, the workflow engine, the security service, and the artifact repository, among others. Installing the server involves specifying configuration information for the server, such as the ports that the server uses.
Converting a server to run as a Windows service
If you did not install the HCL Launch server to run as a Windows service, you can convert the server.

Installing
An HCL Launch installation consists of the HCL Launch server, a database, and at least one agent.
- System requirements and performance considerations
  The HCL Launch server runs on Windows™ and UNIX™ systems. Following some guidelines can improve the performance of the server and agents.
- Firewall and communication configuration
  This topic describes the communication between the HCL Launch components, the firewall, and the ports involved in the communication.
- Installing the server database
  HCL Launch requires a database. You can use the following database types for an evaluation or production server.
- Installing the server
  The server provides services such as the user interface used to configure application deployments, the workflow engine, the security service, and the artifact repository, among others. Installing the server involves specifying configuration information for the server, such as the ports that the server uses.
  - Installing the server in interactive mode
    In interactive mode, you install the server by typing configuration information on the command line.
  - Installing the server in silent mode
    In silent mode, you specify the installation properties in a text file and then run the server installation without command-line prompts.
  - Server installation properties
    The server properties in the installed.properties file control details about the server, such as what ports it uses.
  - Installing the distributed front-end server
    Starting in HCL Launch 7.0.3, you can install a distributed front-end server. The front-end server supports high availability and fault tolerance to ensure success of your application delivery process.
  - Converting a server to run as a Windows service
    If you did not install the HCL Launch server to run as a Windows service, you can convert the server.
- Installing with Kubernetes
  The HCL Launch server can be installed in a cloud-based environment, as a containerized server cluster, managed by Kubernetes. HCL Launch works with Kubernetes to simplify application deployment and manage versions in the containers.
- Installing agents
  You can install agents from the server or from the command line on the agent system. To configure a failover server for an agent, you must install the agent from the command line.
- Installing agent relays
  An agent relay is a communication proxy for agents that are located behind a firewall or in another network location. You can install agent relays in interactive mode or in silent mode.
- Installing plug-ins
  Plug-ins can be installed at any time. You do not need to restart the server after you install a plug-in.
- Starting HCL Launch
  Both UNIX™ and Windows™ installations require the HCL Launch server and at least one agent. If you are using a database other than Derby, make sure that the appropriate driver is installed and configured.
- Installing and uninstalling test fixes (patches) from the server
  Test fixes are provided to correct specific issues. They are applied to the server as patches.

Converting a server to run as a Windows service

If you did not install the HCL Launch server to run as a Windows service, you can convert the server.

Before you begin

Stop the server.

Procedure

On a command line, run the following command as an administrator:
```
service.cmd install service_name
```
Use the name of the service for service_name. To find the service name, open the service.cmd file in a text editor, and search for a line similar to this example: set SERVICE_NAME=ibm-ucd.
Start the server. See Starting and stopping the server.
Start the Windows service.